2021.1.6 Maintenance Release [2022-01-04]

Changelog Overview

• 1 Improvements
• 70 Bug Fixes
• 1 Security Fixes
• 5 Chores
• 2 Tests
• 79 Total Tickets

Improvements

• app-admin_essentials:2.25.42-2021.1.57 [12-21-2021] - Translated titles and labels for Pre-built collections to be human readable.

Bug Fixes

• adapter-automation_gateway:4.17.1-2021.1.4 [12-08-2021] - Added the hasDevicesNornirList method for verifying support of Nornir devices for an adapter instance.
• app-admin_essentials:2.25.42-2021.1.56 [12-21-2021] - Fixed the application banner that displays when applications are not installed on a system.
• app-admin_essentials:2.25.42-2021.1.55 [12-20-2021] - Resolved issue with infinite spinner and the inability to view a pre-built after install. The showLoader is now hidden after import.
• app-admin_essentials:2.25.42-2021.1.54 [12-17-2021] - Fixed UI issue with adapter form scrolling.
• app-admin_essentials:2.25.42-2021.1.53 [12-16-2021] - Fixed issue where schema errors for adapters were not immediately displayed when switching to advanced view.
• app-admin_essentials:2.25.42-2021.1.52 [12-15-2021] - Updated scrolling on the details page form.
• app-admin_essentials:2.25.42-2021.1.51 [12-14-2021] - Updated Rodeo icon version.
• app-admin_essentials:2.25.42-2021.1.50 [12-14-2021] - Modified the setPaginator code for sidebar menu navigation to resolve an infinite loop in pagination due to latency.
• app-admin_essentials:2.25.42-2021.1.49 [12-09-2021] - Fixed prebuilt import screen in Admin Essentials.
• app-admin_essentials:2.25.42-2021.1.48 [12-08-2021] - Improved error handling when importing an invalid integration model. A validation error is now displayed to alert user of invalid file/document type.
• app-ag_manager:1.13.0-2021.1.3 [12-08-2021] - Updated the Nornir module execution path to utilize the Nornir specific inventory when verifying devices on an adapter.
• app-automation_studio:3.35.20-2021.1.97 [12-21-2021] - Fixed a bug that caused the workflow to lose reference to the JSON form_id inside of the ShowJsonForm task.
• app-automation_studio:3.35.20-2021.1.96 [12-20-2021] - Improved handling of task variables that accept objects.
• app-automation_studio:3.35.20-2021.1.95 [12-17-2021] - Dynamic dropdowns correctly transform data when using JST documents.
• app-automation_studio:3.35.20-2021.1.94 [12-16-2021] - Changed Gen 2 Scheduler name to Run Window.
• app-automation_studio:3.35.20-2021.1.93 [12-14-2021] - Enhanced the code logic for editing boolean values. Tasks will correctly recognize the uninitialized boolean values and pass the appropriate data to the editor.
• app-automation_studio:3.35.20-2021.1.91 [12-10-2021] - Authorization warnings will display when user does not have the appropriate transformation permissions.
• app-automation_studio:3.35.20-2021.1.90 [12-08-2021] - Fixed race condition when importing a Pre-built containing multiple workflows created by the same user.
• app-automation_studio:3.35.20-2021.1.89 [12-07-2021] - Fixed issue where variables with a * data type were not properly saved in Gen 2 workflows.
• app-automation_studio:3.35.20-2021.1.88 [12-06-2021] - Implemented validation checks to prevent task search from crashing when there are custom integrations.
• app-automation_studio:3.35.20-2021.1.87 [12-03-2021] - Fixed a MongoDB projection bug that prevented importing Pre-builts with templates.
• app-configuration_manager:3.74.24-2021.1.25 [12-13-2021] - Corrected an issue with APIs having the same endpoint.
• app-configuration_manager:3.74.24-2021.1.24 [12-09-2021] - The view configuration difference dialog correctly displays the full difference information without the horizontal scroll.
• app-configuration_manager:3.74.24-2021.1.23 [12-09-2021] - Fixed an issue with the View Config Difference tool. No difference is shown for identical lines between a Golden Configuration and the imported device config.
• app-configuration_manager:3.74.24-2021.1.22 [12-06-2021] - Fixed the interface name and IP address normalization for ios-xr golden configurations.
• app-configuration_manager:3.74.24-2021.1.21 [12-03-2021] - Fixed prebuilt imports for Golden Configuration trees.
• app-configuration_manager:3.74.24-2021.1.20 [12-02-2021] - Resolved all listed errors in the browser console for Configuration Manager.
• app-form_builder:4.10.1-2021.1.12 [12-16-2021] - Added authorization warnings when a user does not have transformation permissions.
• app-form_builder:4.10.1-2021.1.11 [12-01-2021] - Applied engineering role in pronghorn.json file to fix invalid configuration of application roles.
• app-json_forms:1.30.12-2021.1.13 [12-14-2021] - Added the ability to import a JSON Form with a new form_id if the id already exists in data storage.
• app-jst:1.3.10-2021.1.50 [12-16-2021] - Updated the navigation bar with the correct design and links for the current version of IAP.
• app-jst:1.3.10-2021.1.49 [12-13-2021] - Updated permissions to ensure admins are authorized to view JST Designer.
• app-mop:6.10.2-2021.1.14 [12-17-2021] - Improved logging of objects.
• app-mop:6.10.2-2021.1.13 [12-13-2021] - Added authorization warnings when a user does not have permissions to view or create a transformation.
• app-operations_manager:1.47.0-2021.1.59 [12-17-2021] - UI elements are no longer viewable to the user without the proper permission when viewing Automation Collections.
• app-operations_manager:1.47.0-2021.1.58 [12-17-2021] - Fixed missing groups in the automation metadata drawer. All IAP authorization groups are returned when searching groups in Authorization Manager.
• app-operations_manager:1.47.0-2021.1.57 [12-13-2021] - Fixed a bug that prevented Operations Manager from reliably loading events from other components when the launchDelay system setting was used.
• app-operations_manager:1.47.0-2021.1.56 [12-07-2021] - UI elements are no longer viewable to the user without the proper permission.
• app-operations_manager:1.47.0-2021.1.55 [12-03-2021] - Changed manual triggers to allow automations to run without form data.
• app-workflow_builder:5.40.5-2021.1.59 [12-14-2021] - The Gen 2 workflow will open in a new canvas when it is reached via Global Search results.
• app-workflow_builder:5.40.5-2021.1.58 [12-13-2021] - Authorization warnings will display when user does not have the appropriate transformation permissions.
• app-workflow_builder:5.40.5-2021.1.57 [12-09-2021] - Fixed bug where certain modals were redirected to a broken login screen if a user was no longer authenticated.
• app-workflow_builder:5.40.5-2021.1.56 [12-07-2021] - Fixed a bug that allowed parent jobs to start despite missing the job variables needed to run the job. This fix ensures all job variables of a childJob are pulled (requested) and listed.
• app-workflow_builder:5.40.5-2021.1.55 [12-07-2021] - Fixed an invalid JSON schema keyword for allOf in workflow schemas.
• app-workflow_builder:5.40.5-2021.1.54 [12-07-2021] - Fixed a bug that allowed saving automation without any tasks on the canvas. With this fix, users cannot save a workflow without at least one task.
• app-workflow_builder:5.40.5-2021.1.53 [12-07-2021] - Users are redirected to the Automation Studio main page upon automation deletion.
• app-workflow_engine:9.6.32-2021.1.123 [01-06-2022] - Fixed an issue where sequential child job loops could infinitely loop.
• app-workflow_engine:9.6.32-2021.1.122 [01-06-2022] - Improved job start handling to prevent orphan jobs. The startJobWithOptions API will not allow jobs to start until all services are launched and the task sender is activated.
• app-workflow_engine:9.6.32-2021.1.121 [01-05-2022] - Clicking the message or body field of the ViewData task will now select the entire field.
• app-workflow_engine:9.6.32-2021.1.120 [12-30-2021] - Removed title property key from finishTaskWorker.
• app-workflow_engine:9.6.32-2021.1.119 [12-14-2021] - Fixed issue where encoding the return data of the searchJobs task caused the task to error.
• app-workflow_engine:9.6.32-2021.1.117 [12-10-2021] - Updated query task to take the failure path if a nested key does not exist in the queried object.
• app-workflow_engine:9.6.32-2021.1.116 [12-09-2021] - Fixed the transformation task from showing an incorrect value for job variable inputs.
• app-workflow_engine:9.6.32-2021.1.115 [12-09-2021] - Implemented a validation check to ensure that job execution will not freeze if the reference task is not defined when adding decorators for task execution.
• app-workflow_engine:9.6.32-2021.1.114 [12-08-2021] - Fixed issue in array map task where false values in the map parameter were set to null in the return object.
• app-workflow_engine:9.6.32-2021.1.113 [12-06-2021] - Updated child job icon.
• app-workflow_engine:9.6.32-2021.1.112 [12-03-2021] - Removed queryTasks call from Job Details.
• pronghorn-core:12.1.24-2021.1.78 [01-06-2022] - Yang-based form fields with defaults will not be ignored in XPath evaluation.
• pronghorn-core:12.1.24-2021.1.77 [01-05-2022] - Fixed an issue where default properties were not added when the adapter is created.
• pronghorn-core:12.1.24-2021.1.76 [12-31-2021] - Modified the swagger.css code to fix scrolling issue on Help page. The toolbar at top of page remains stationary.
• pronghorn-core:12.1.24-2021.1.75 [12-30-2021] - Fixed a bug that caused a missing connection status in the tooltip when an adapter went offline. The 'offline' status now displays as expected.
• pronghorn-core:12.1.24-2021.1.74 [12-16-2021] - Views property on pronghorn.json models is no longer required for starting applications and adapters.
• pronghorn-core:12.1.24-2021.1.73 [12-14-2021] - Improved validation of model properties on startup to ensure invalid methods or views will log better errors for failing to start services.
• pronghorn-core:12.1.24-2021.1.72 [12-14-2021] - Reordered errors during Pre-built validation to ensure recoverable errors are thrown last.
• pronghorn-core:12.1.24-2021.1.72 [12-14-2021] - Updated the iap-ui dependency to the correct link for Itential Academy.
• pronghorn-core:12.1.24-2021.1.71 [12-14-2021] - Improved error handling by adding defensive code for API routes with odd characters in them.
• pronghorn-core:12.1.24-2021.1.70 [12-08-2021] - Fixed bug where the last application used in a custom role was not properly displayed.
• pronghorn-core:12.1.24-2021.1.69 [12-08-2021] - Expanded the try-catch statement in Sheriff.js for better exception handling on shutdown.
• pronghorn-core:12.1.24-2021.1.68 [12-07-2021] - Improved handling of adapter schema validation when using encrypted values.
• tags:3.1.4-2021.1.1 [12-22-2021] - Fixed a bug that caused the tags search option in Automation Studio to fail due to unescaped characters used in the search query. Implemented a constructor to validate escape strings for regular expressions.

Security Fixes

• app-json_forms:1.30.12-2021.1.12 [12-10-2021] - Removed the Axios library.

Chores

• app-automation_studio:3.35.20-2021.1.98 [12-21-2021] - Updated JST Designer dependencies to latest version.
• app-automation_studio:3.35.20-2021.1.92 [12-10-2021] - Updated JST Designer dependency to latest version.
• app-jst:1.3.10-2021.1.51 [12-21-2021] - Updated jst-designer dependency to latest version.
• app-jst:1.3.10-2021.1.48 [12-10-2021] - Updated jst-designer dependency to latest version.
• app-operations_manager:1.47.0-2021.1.54 [12-02-2021] - Updated the network dependency to fix an issue where using special characters in a password would generate errors when connecting to RabbitMQ.

Tests

• app-admin_essentials:2.25.42-2021.1.50 [12-14-2021] - Added cypress tests to verify that the Admin Essentials UI has the username of logged in user.
• app-workflow_engine:9.6.32-2021.1.118 [12-11-2021] - Added unit tests for migration scripts.

2021.1.6 Release Versions

Automation Platform Versions

component	version
@itential/adapter-automation_gateway	4.17.1-2021.1.4
@itential/adapter-azure_aaa	1.1.9-2021.1.1
@itential/adapter-email	3.1.20-2021.1.2
@itential/adapter-ldap	2.12.21-2021.1.2
@itential/adapter-local_aaa	4.2.8-2021.1.1
@itential/adapter-nso	7.1.3-2021.1.4
@itential/adapter-radius	2.0.12-2021.1.0
@itential/adapter-redis	2.0.17-2021.1.0
@itential/app-admin_essentials	2.25.42-2021.1.57
@itential/app-ag_manager	1.13.0-2021.1.3
@itential/app-automation_catalog	2.10.6-2021.1.14
@itential/app-automation_studio	3.35.20-2021.1.98
@itential/app-configuration_manager	3.74.24-2021.1.25
@itential/app-form_builder	4.10.1-2021.1.12
@itential/app-json_forms	1.30.12-2021.1.13
@itential/app-jst	1.3.10-2021.1.51
@itential/app-mop	6.10.2-2021.1.14
@itential/app-nso_manager	2.20.15-2021.1.2
@itential/app-operations_manager	1.47.0-2021.1.59
@itential/app-service_catalog	3.10.19-2021.1.1
@itential/app-service_management	2.24.0-2021.1.2
@itential/app-template_builder	2.5.3-2021.1.4
@itential/app-workflow_builder	5.40.5-2021.1.59
@itential/app-workflow_engine	9.6.32-2021.1.123
@itential/pronghorn-core	12.1.24-2021.1.78
@itential/search	1.1.14-2021.1.2
@itential/tags	3.1.4-2021.1.1
@itential/itential-utils	2.7.4

Automation Gateway Versions

component	version
automation_gateway	3.130.2+2021.1.32

NSO Manager Versions

component	version
itential-tools	1.23.31.2021.1.4

Engine Versions

component	version
policy-engine	1.10.7+2021.1.0

Dependencies

Automation Platform Server

package	supported versions	recommended version
nodejs	>= 12.22.1 <= 14	14.17.3
npm	6.x	6.14.15
python	2.x or 3.x	3.9.8

pip	supported	recommended
pip	any version	21.3.1
textfsm	1.x	1.1.2
Jinja2	2.x	2.11.3

The gcc-c++ and make packages should be installed from your OS distribution.

Mongo Server

package	supported	recommended
mongodb	4.2.x	4.2.13

RabbitMQ Server

package	supported	recommended
rabbitmq	3.8.x	3.8.14
erlang	21.3+ or 22.x	22.3.1
elixir	1.10.x	1.10.4
dedup	0.5.x	0.5.0

Redis Server

package	supported	recommended
redis	5.x	5.0.12

The gcc-c++ and make packages should be installed from your OS distribution.

Hashicorp Vault

package	supported	recommended
vault	1.x	1.7.0

Automation Gateway

package	supported	recommended
python	3.9	3.9.8
openssl	1.x	1.1.1l
haproxy	2.x	2.2.14

The gcc-c++ and make packages should be installed from your OS distribution.

The following development packages are required to install automation gateway: libffi-dev, openssl-dev, python-dev, sqlite-dev.

pip package	supported	recommended
pip	20.2.4	20.2.4
ansible	2.9 or 2.10	2.10.7
terraform	0.12.x	0.12.31
nornir	3.x	3.1.1
netmiko	3.x	3.4.0

One or more of the following packages may be required by the specific ansible modules you're using: psutil, pycrypto, paramiko, ncclient, lxml, nitrosdk-python, jxmlease.

Check the ansible documentation for the roles you're planning to use for additional package requirements.

NSO/Itential Tools

package	supported	recommended
java	1.7 or 1.8	1.8.275.01

The ant package should be installed from your OS distribution.

IAP Compatibility

Device Configuration

Device Configuration compatibility describes which devices are expected to work with the basic features of the Configuration Manager application across various southbound systems.

Ansible:

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

NSO:

Refer to the NSO Versions and NED Versions tables below for a list of tested devices.

Device Compliance

Device Compliance compatibility describes which devices are expected to work with Golden Configurations.

Ansible:

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

NSO (Configuration Manager app):

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

Device Maintenance

Device Maintenance compatibility describes which devices Itential can perform maintenance activities on (e.g., reboots and firmware upgrades).

Ansible:

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Juniper Junos

NSO:

* cisco-ios
* cisco-iosxr
* juniper-junos

Device Health Checks

Device Health Checks compatibility describes which devices Itential can execute read-only show commands to use the method broker and Command Templates application.

Ansible:

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

NSO:

* a10-acos
* alu-sr
* arista-dcs
* cienacli-acos
* cisco-aireos
* cisco-asa
* cisco-gss
* cisco-ios
* cisco-iosxr
* cisco-nx
* cisco-qps
* cisco-staros
* ericsson-sgsnmme
* f5-bigip
* huawei-vrp
* juniper-junos

Note: Some of the devices in the health checks category are tested against netsim devices.

Forms

Ansible:

IAP can render most ansible networking modules as forms. Support for specific modules may vary. If you encounter issues with any particular modules, reach out to the Itential Customer Success Team for assistance.

NSO:

IAP can render most service models advertised by NSO as forms. Support for specific yang features may vary. If you encounter issues with your service models, reach out to the Itential Customer Success Team for assistance.

Service Provisioning

NSO:

IAP can provision most service models advertised by NSO. Support for specific yang features may vary. If you encounter issues with your service models, reach out to the Itential Customer Success Team for assistance.

Devices/Services Compatibility

The Itential Automation Platform is tested against the following component versions.

Ansible Versions:

* 2.10.7
* 2.9.27

Ansible Modules:

* eos_facts
* eos_command
* eos_config
* ios_facts
* ios_command
* ios_config
* iosxr_facts
* iosxr_command
* iosxr_config
* nx_facts
* nx_command
* nx_config
* junos_facts
* junos_command
* junos_config

NSO Versions:

* 5.4.4
* 5.5.1
* 5.6

NSO NED Versions:

ned	5.4.4	5.5.1	5.6
a10-acos	3.18	3.18	3.18
adtran-aos	4.0.6	4.0.6	4.0.6
alu-sr	8.13.4	8.13.4 8.13.3	8.13.3 6.13.4 8.21
arista-dcs	5.20.2	5.20.2 5.20	5.20.2 5.23
checkpoint-gaiaos_rest	n/a	1.10.7 1.10.6	1.10.7 1.10.6 1.10.22
ciena-acos	6.2.5	6.2.5 6.2.4	6.2.4 6.2.5 6.4
cisco-aireos	3.7.2 3.7.1	3.7.2 3.7.1	3.7.1 3.7.2 3.9.3
cisco-asa	6.12.4	6.12.4 6.12.3	6.12.3 6.12.4 6.13.6
cisco-gss	2.1.1	2.1.1	2.1.1
cisco-ios	6.69 6.68.2	6.69 6.68.2	6.68.2 6.72.2 6.74.11
cisco-iosxr	7.33	7.33 7.32.5	7.32.5 7.33 7.36
cisco-nx	5.21.1	5.21.1 5.21	5.21.1 5.22.1
cisco-qps	5.1.3	5.1.3	5.1.3 5.1.7
cisco-staros	5.34.6 5.34.5	5.34.6 5.34.5	5.34.5 5.34.6 5.41.1
ericsson-sgsnmme	1.0.7	n/a	n/a
f5-bigip	3.17 3.16	3.17 3.16	3.16 3.17 3.21.1
fortinet-fortios	5.4.21	5.4.21 5.4.20	5.4.20 5.4.21 5.5
huawei-usn	1.2.1	n/a	n/a
huawei-vrp	6.17.4 6.17.3	6.17.4 6.17.3	6.17.3 6.17.4 6.26.8
juniper-junos	4.6.19 4.6.17	4.6.19 4.6.17	4.6.19 4.6.23 4.6.33
paloalto-panos_cli	4.8.2 4.8.1	4.8.2 4.8.1	4.8.2 4.8.1 4.8.8
radware-alteonos	2.4.1	2.4.1 2.4	2.4.1 2.4
unix-bind	2.1.0	2.1.0	2.1.0 2.1.3

VTS Versions:

* 2.6.2

VTS NED Versions:

ned	2.6.2
cisco-iosxr	6.6
cisco-ncs5500	1.0
cisco-nx	5.1.4

Virtual Devices:

* A10 vThunder 4.1.4 GR1
* Arista EOS-4.23.0FX
* Checkpoint R80.30-273.583
* Cisco ASAv 9.13.1.7
* Cisco CSR 17.02.01r
* Cisco NX 9.3.2, 9.3.1
* Cisco StarOS 21.15.29
* Cisco XR6.3.1
* F5 BIGIP 15.1.0.2-0.0.9
* Fortigate 6.4.0
* Juniper VMX 18.4R1
* Juniper VSRX 19.1R2
* PanOS 9.1.2
* Radware 32.6.0.0

IAP Browser Compatibility

This maintenance release was tested against the following browser versions:

* Firefox 89
* Chrome 91.0.4472.77
* Edge 91.0.864.37
* Internet Explorer 11